home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / COMMUNIC / 1154.ZIP / DSZ0329.ARC / dsz.doc < prev    next >
Text File  |  1988-03-29  |  49KB  |  1,453 lines
  1.  
  2.  
  3.  
  4.           DSZ - a ZMODEM, True YMODEM(TM), XMODEM File Transfer Program
  5.  
  6.                                   Chuck Forsberg
  7.  
  8.                                Omen Technology Inc
  9.  
  10.  
  11.                            Omen Technology Incorporated
  12.                           The High Reliability Software
  13.  
  14.                        17505-V Northwest Sauvie Island Road
  15.                               Portland Oregon 97231
  16.               Modem: 503-621-3746 Speed 1200,2400,19200(Telebit PEP)
  17.                          Compuserve:70007,2304  GEnie:CAF
  18.                         UUCP: ...!tektronix!reed!omen!caf
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.     Chapter 0              Rev 3-27-88  Typeset 3-29-88                      1
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.     Chapter 0                  DSZ Quick Reference                           2
  71.  
  72.  
  73.  
  74.     1.  LICENSING INFORMATION
  75.  
  76.     If you received dsz with another progam, even if your copy of the other
  77.     program is registered, this copy of dsz has not been registered.
  78.  
  79.     Dsz is not and never has been public domain.  Every version of dsz has
  80.     included a Copyright Notice and a prohibition against sale or
  81.     modification.  Dsz is not free software.  There is no usage counter or
  82.     other Trojan Horse in dsz, but if you use this program, you ought to
  83.     register it.
  84.  
  85.     Dsz is a user supported program developed and supported by Chuck Forsberg,
  86.     owner of Omen Technology.  Long hours of work and expen$ive resources went
  87.     to develop and support dsz for the myriad environments users use it in.
  88.  
  89.     Unlike snazzy menu interfaces, developing reliable high speed transfer
  90.     protocols takes many hours of testing, often over expensive phone
  91.     connections.  Two decades of communications experience and protocol
  92.     testing are distilled in Dsz.
  93.  
  94.     Thank you for your support.
  95.  
  96.     Non registered users are granted a license to use dsz for a limited
  97.     evaluation period.  Otherwise, use of dsz requires registering the copy.
  98.  
  99.     Registration enables advanced features.
  100.  
  101.     1.1  Sharing DSZ Files
  102.  
  103.     Feel free to share unmodified, unserialized copies of DSZ.ARC with your
  104.     friends and associates for their evaluation.  This documentation file and
  105.     the MAILER file must be provided with all copies of DSZ except by prior
  106.     written permission from Omen Technology Inc.
  107.  
  108.     No version of dsz may be sold, modified, patched, hacked, disassembled,
  109.     decompiled, or otherwise reverse engineered without the prior written
  110.     permission of Omen Technology Inc.
  111.  
  112.     Distribution of programs and/or instructions on how to modify, patch,
  113.     disassemble, decompile, or otherwise reverse engineer dsz without prior
  114.     written permission by Omen Technology Inc is a theft of services and a
  115.     violation of federal copyright law, and will be referred to the FBI for
  116.     investigation and prosecution under federal conspiricy statutes.
  117.     Applicable RICO law provides for treble damages and recovery of attorney's
  118.     fees.
  119.  
  120.     Distribution of dsz in any medium without this documentation file is an
  121.     unauthorized modification to dsz in an attempt to deprive the rightful
  122.     author of registration revenues.  That is a theft of intellectual
  123.     property.
  124.  
  125.  
  126.  
  127.  
  128.     Chapter 1              Rev 3-27-88  Typeset 3-29-88                      2
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.     Chapter 1                  DSZ Quick Reference                           3
  137.  
  138.  
  139.  
  140.     If any version of dsz is distributed with any other product, software or
  141.     hardware, the product documentation must clearly and promimently state
  142.     that the customer's continued use of dsz requires registration directly
  143.     with Omen Technology or its duly authorized agent(s).  When dsz is
  144.     distributed on disk, a contemporary copy of ZCOMMDOC.ARC must be included
  145.     on the same disk.
  146.  
  147.     1.2  REGISTRATION
  148.  
  149.     After a short evaluation period, users should register their copy of dsz
  150.     with a check for $20.00 in U.S. funds sent to:
  151.  
  152.            Omen Technology Inc.
  153.            P.O. Box 4681
  154.            Portland, OR 97208
  155.  
  156.     Canadians should remit to:
  157.  
  158.            Dynamis Productivity Software LTD
  159.            P. O. Box 5008, Station B
  160.            Victoria BC v8r 6n3
  161.  
  162.     The address on your check is sufficient, no need to fill out forms.
  163.  
  164.     Don't bother scrounging for an envelope, just print the INSTANT MAILER
  165.     included in this archive!
  166.  
  167.     Users, especially those overseas, may choose to register their copy of dsz
  168.     for $25.00 U.S.  by providing their VISA or Mastercard card number with
  169.     expiration date and their name as it appears on their credit card.
  170.  
  171.            ***********************************************************
  172.     The user registration package includes a printed serial number card,
  173.     latest versions of the DSZ programs, the installation program which
  174.     enables features and bypasses the opening advertisement, and additional
  175.     documentation.
  176.  
  177.     The registration package serializes all past and future versions of
  178.     DSZ.COM and DSZ.EXE.
  179.            ***********************************************************
  180.  
  181.     The unique serial number on the registration card is registered to the
  182.     user, and is accecptable proof of registration to corporate auditors.
  183.  
  184.     The putsnp program inserts your unique DSZ Serial Number Password (SNP)
  185.     into you copy of DSZ:
  186.            putsnp dsz.com
  187.     Putsnp accepts your SNP and asks appropriate questions before inserting
  188.     the SNP.
  189.  
  190.     The only legitimate way to disable the opening advertisement in dsz is to
  191.  
  192.  
  193.  
  194.     Chapter 1              Rev 3-27-88  Typeset 3-29-88                      3
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.     Chapter 1                  DSZ Quick Reference                           4
  203.  
  204.  
  205.  
  206.     insert an authorized SNP obtained from Omen Technology into dsz with the
  207.     putsnp program.  Any other suppression or modification of the opening
  208.     screen is an illegal, unethical theft of services.
  209.  
  210.  
  211.     1.3  Files on User Disk
  212.  
  213.     The following files are currently included on the User Disk that is sent
  214.     to paid registrants.
  215.  
  216.     DSZEXE.ZOO     Contains DSZ.EXE.
  217.  
  218.  
  219.     DSZ.ARC        Contains DSZ.COM and this document.
  220.  
  221.  
  222.     YZMODEM.ZOO    Contains Official YMODEM and ZMODEM protocol descriptions.
  223.  
  224.  
  225.     LOOZ.DOC       Documentation on running the LOOZ program
  226.  
  227.  
  228.     LOOZ.EXE       Program to unpack .ZOO archives
  229.  
  230.  
  231.     RZSZ.ZOO       ZMODEM C source code, porting base for several dozen ZMODEM
  232.                    implementations
  233.  
  234.  
  235.     PUTSNP.EXE     Installs your own registered serial number into DSZ.
  236.  
  237.  
  238.     DSZBG.DOC      Background information for DSZ, part of the ZCOMM User's
  239.                    Manual.
  240.  
  241.     1.4  Bulletin Board Registration
  242.  
  243.     Dsz may be freely used and copied by bulletin board systems which agree to
  244.     feature the ZCOMM files (ZCOMMEXE.ARC, ZCOMMDOC.ARC, ZCOMMHLP.ARC) for
  245.     downloading.
  246.  
  247.     Omen Technology provides free bulletin board registrations under the
  248.     condition stated above to encourage the use of ZCOMM and Professional-YAM
  249.     communications software.  A Dsz registration and diskettes with current
  250.     versions of the ZCOMM files (for bulletin board downloading) will be
  251.     mailed upon validation as a full time public bulletin board.  Bulletin
  252.     boards meeting these requirements may register dsz without charge by
  253.     mailing a letter with your bulletin board's mailing address, telephone
  254.     number and valid login (account and password).
  255.  
  256.     Free bulletin board registrations are accepted by post office mail only.
  257.  
  258.  
  259.  
  260.     Chapter 1              Rev 3-27-88  Typeset 3-29-88                      4
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.     Chapter 1                  DSZ Quick Reference                           5
  269.  
  270.  
  271.  
  272.     The accumulation of free bulletin board registrations are fulfilled at
  273.     infrequent intervals when a major new release of ZCOMM is available.
  274.  
  275.  
  276.     2.  DESCRIPTION
  277.  
  278.     Dsz is a "protocol driver" that uses the ZMODEM, True YMODEM(TM), or
  279.     XMODEM protocol to transfer files over a serial port with a variety of
  280.     programs.
  281.  
  282.     ZMODEM Transfers feature 32 bit CRC, crash recovery, and advanced file
  283.     management.
  284.  
  285.     When calling bulletin boards to download files with ZMODEM or True
  286.     YMODEM(TM), you can avoid the bother of starting DSZ for each transfer by
  287.     calling dsz first, before asking the BBS for the download (dsz t).  The
  288.     "t" command allows you to keyboard the file request to the BBS.  DSZ's
  289.     ZMODEM AutoDownload then receives the file automatically, without any
  290.     wasted keystrokes or delay.  Try it, you'll like it!  (The "t" command is
  291.     described below.)
  292.  
  293.     ZMODEM and True YMODEM(TM) transfers preserve exact file length and
  294.     modification time.
  295.  
  296.     Dsz supports XMODEM-1k (XMODEM with 1024 byte blocks, sometimes mislabeled
  297.     YMODEM) and CRC-16 with the sx -k and rc commands.
  298.  
  299.     Dsz is derived from Omen Technology's Professional-YAM communications
  300.     software, (also published by POLYTRON Corp of Hillsboro Oregon as
  301.     PowerCom(TM)), and supports a subset of Pro-YAM's file transfer related
  302.     commands.  This documentation makes extensive references to contemporary
  303.     editions of the ZCOMM or Pro-YAM manual, and is incomplete without it.
  304.  
  305.     Dsz is designed to be called from a communications bulletin board program.
  306.     Dsz may also be called from other communications programs, but the
  307.     combination lacks much of the enjoyable user friendliness of a program
  308.     with integrated ZMODEM.
  309.  
  310.     Dsz uses its own modem I/O.  The original interrupt vector, UART parity,
  311.     interrupt configuration, and 8259 interrupt mask are restored on exit.
  312.  
  313.     Dsz uses DOS standard output (stdout) for messages.  It never writes
  314.     directly to the screen.  Dsz expects its standard output to point to the
  315.     console, a logging file, or NUL, not the modem port.  If dsz's standard
  316.     output is redirected to the modem (as with ProComm's Host mode DOS shell),
  317.     the combination may lock up the computer.  If necessary, dsz's standard
  318.     output may be redirected back to the console device with the CON command.
  319.  
  320.     Dsz exits with 0 status for successful transfers, or the value of the Q
  321.     parameter (default 1) if a file transfer failed.  Some languages do not
  322.     return this information to the calling program.  A batch file that calls
  323.  
  324.  
  325.  
  326.     Chapter 2              Rev 3-27-88  Typeset 3-29-88                      5
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.     Chapter 2                  DSZ Quick Reference                           6
  335.  
  336.  
  337.  
  338.     dsz directly may be used to detect the dsz exit status, or dsz's log file
  339.     entries may be examined.
  340.  
  341.  
  342.     3.  COMMANDS
  343.  
  344.     dsz [CON] [port N] [speed S] [handshake XX] [D] [d] command
  345.  
  346.     Dsz commands are an improper subset of Pro-YAM/PowerCom/ZCOMM commands.
  347.  
  348.            ***********************************************************
  349.                                     NOTE WELL
  350.     Except as noted, all commands must be in entered lower case.  (Case is
  351.     significant!)
  352.            ***********************************************************
  353.  
  354.     When used (in any combination), the CON, port, speed, handshake, and d
  355.     commands must be given in the order shown.
  356.  
  357.  
  358.     CON   Redirect message output to the DOS "CON" (console) device,
  359.           overriding any previous redirections.  This prevents lockups when
  360.           used with certain communications programs.
  361.  
  362.     handshake XX Enable one of several choices of hardware handshake.  (The
  363.           default is XOFF/XON software handshake).  This command is documented
  364.           in the ZCOMM or Pro-YAM manual.  (The ZCOMM manual is available on
  365.           all registered bulletin boards as ZCOMMDOC.ARC.)
  366.  
  367.     port N select port N (n = 1,2,3,4 ... 8) Default is port 1 (COM1) or read
  368.           from the DSZPORT dos environment variable.  In multitasking
  369.           operation, accessing a port used by another running program may hang
  370.           the machine.
  371.           EXAMPLE: to use COM2:
  372.           dsz port 2 rz
  373.  
  374.     speed S Set the specified speed.  This command is rarely needed because
  375.           dsk reads the port's current speed by default.  Please refer to to
  376.           the FLOW CONTROL, MAIN COMMANDS and SOFTWARE COEXISTENCE chapters in
  377.           the ZCOMM or Pro-YAM manual for important information about the
  378.           speed command.
  379.  
  380.     D     Disables the modem (drops Data Terminal Ready, DTR) if carrier is
  381.           lost.  This may be used to prevent spurious events (phone ringing)
  382.           from interfering with the calling bulletin board's recovery from
  383.           carrier loss.
  384.  
  385.     d     Disables carrier dropout monitoring, for modems that do not properly
  386.           drive the "Data Carrier Detect" input on the PC.
  387.  
  388.  
  389.  
  390.  
  391.  
  392.     Chapter 3              Rev 3-27-88  Typeset 3-29-88                      6
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.     Chapter 3                  DSZ Quick Reference                           7
  401.  
  402.  
  403.  
  404.     LARG  Convert ARG to lower case, then parse arg.
  405.  
  406.     pxN   Set a numeric parameter x to N.  These parameters are mostly a
  407.           subset of the Pro-YAM/ZCOMM numeric parameters, and are listed
  408.           below.  They assume their defaults each time dsz is called.  Without
  409.           an argument, p displays the numeric parameters and their values.
  410.  
  411.           EXAMPLE: C>dsz p
  412.  
  413.           z pxN Set zmodem numeric parameter x to N.  These parameters
  414.           correspond to the Pro-YAM or ZCOMM "zmodem" parameters and rarely
  415.           need changing.  These parameters assume their defaults each time dsz
  416.           is called.  Without an argument, z p displays the zmodem numeric
  417.           parameters and their values.
  418.  
  419.     restrict Restrict pathnames to the current disk and directory tree, and
  420.           disallow overwriting of existing files.  When dsz is restricted, it
  421.           will refuse to transfer files containing the string autoexec.bat and
  422.           command.com in upper or lower case.  This provides some defense from
  423.           malicious uploaded files.
  424.  
  425.     t     [-8g] Talk with ZMODEM AutoDownload.  The optional -8g (available on
  426.           registered copies only) allows "BBS (ANSI) graphics".  A small
  427.           subset of ZCOMM/Pro-YAM term function subcommands are recognized.
  428.           Keyboard F1 or ALT-X to exit.  F3 receives file(s) with True
  429.           YMODEMTm, ALT-P toggles parity between the 8n default and 8g
  430.           (enables ANSI "graphics").  ALT-H toggles two local echo ("Half
  431.           Duplex") modes; the second displays a newline on Enter.  Keyboarded
  432.           ASCII characters are sent to the modem.  Modem characters print on
  433.           the screen.  A device driver such as ANSI.SYS may be used to
  434.           recognize escape sequences.  ZMODEM AutoDownload detects the start
  435.           of a ZMODEM file download and accepts the file(s) without operator
  436.           intervention.
  437.  
  438.     rz    [-abenprt+Yy] [dir] [file ...]          (ZMODEM receive)
  439.  
  440.     rb    [-abt+y] [dir] [file ...]     (YMODEM receive)
  441.  
  442.     rb -g [-abt+y] [dir] [file ...]     (YMODEM-g receive)
  443.  
  444.     rc    [-abt+y] file1                (XMODEM/CRC receive)
  445.  
  446.     ro    [-abt+y] file1                (XMODEM OverThruster receive)
  447.  
  448.     rx    [-abt+y] file1                (XMODEM receive)
  449.  
  450.     rx    -g [-abt+y] file1             (Qmodem-G receive)
  451.  
  452.  
  453.     sz    [-abefnprtY+y] [-w[N]]  file ...        (ZMODEM send)
  454.  
  455.  
  456.  
  457.  
  458.     Chapter 3              Rev 3-27-88  Typeset 3-29-88                      7
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.     Chapter 3                  DSZ Quick Reference                           8
  467.  
  468.  
  469.  
  470.     sb    [-ft] [PREFIX=p | ONAME=n] file ...     (YMODEM, YMODEM-g send)
  471.  
  472.     sb -k [-ft] [PREFIX=p | ONAME=n] file ...     (YMODEM-1k send)
  473.  
  474.     sx    [-t] file1                    (XMODEM, XMODEM/CRC, Qmodem-G send)
  475.  
  476.     sx -k [-t] file1                    (XMODEM-1k send)
  477.     The meanings of the optional arguments are described in the ZCOMM manual.
  478.  
  479.     3.1  Interrupt Keys
  480.  
  481.     Ctrl-Break Terminates the transfer in progress.
  482.  
  483.     ALT-N Abruptly terminates (NUKES) the transfer in progress.
  484.  
  485.     Ctrl-X Typing a dozen Ctrl-X characters to another ZMODEM program
  486.          trminates ZMODEM operations.
  487.  
  488.  
  489.     4.  EXAMPLES
  490.  
  491.     dsz sz c:foo.* b:*.c          (send files)
  492.  
  493.     dsz sz -r yzmodem.arc         (CRASH RECOVERY: resume interrupted
  494.     transfer)
  495.  
  496.     dsz handshake both sz yzmodem.arc       (Hardware+Software handshake)
  497.  
  498.     dsz sz -n *.*                 (send files that are newer or rx has no
  499.     copy)
  500.  
  501.     dsz sz -Yn *.*                (Only send files that are newer than
  502.     receiver's copy)
  503.                                   (Do not send files that do not exist on
  504.     receiver's disk)
  505.  
  506.     dsz rz C:/UPLOADS             (receive files to specified directory)
  507.  
  508.     dsz port 2 speed 38400 restrict rz
  509.  
  510.     dsz rz  -y prog.arc           (ZMODEM, single file pathname override)
  511.  
  512.     dsz z pr1 rx foo.dat          (XMODEM receive, remove file if error)
  513.  
  514.     dsz pO60 ro foo.dat           (XMODEM/OverThruster receive, GEnie MNP)
  515.  
  516.     DSZ LRC L-Y NEWPROG.ARC       (generate lower case "rc -y" command)
  517.  
  518.     dsz pv2 sz foo >debug.dmp     (Debugging data dump)
  519.  
  520.  
  521.  
  522.  
  523.  
  524.     Chapter 4              Rev 3-27-88  Typeset 3-29-88                      8
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.     Chapter 5                  DSZ Quick Reference                           9
  533.  
  534.  
  535.  
  536.     5.  NUMERIC PARAMETERS
  537.  
  538.     Dsz uses the following main numeric parameters, settable with the pxN
  539.     command.
  540.  
  541.     In addition, dsz uses the Pro-YAM/ZCOMM zmodem numeric parameters
  542.     described in the Pro-YAM/ZCOMM manual.
  543.  
  544.     EXAMPLE: C>dsz pQ0
  545.  
  546.  
  547.     B   Set the size of buffer used for disk reads and writes.  The default is
  548.         1024, 8192 maximum.  If your copy of DSZ is running on a floppy disk
  549.         system or a slow turkey hard disk, a larger value may give better
  550.         results.  Too large a value will exhaust memory or induce receiver
  551.         timeouts.  If performance logging doesn't work, this parameter is too
  552.         big.  This parameter is supported on versions compiled with TurboC.
  553.  
  554.         EXAMPLE: C>dsz pB4096
  555.  
  556.         Some people have problems when setting the buffer size larger, such as
  557.         locking out the performance log.  If you aren't bloody sure you need a
  558.         bigger buffer, don't use one.
  559.  
  560.     Q   Error code returned to DOS (default 1).  (Success returns 0.) Some
  561.         programs toss cookies when confronted with certain exit codes.
  562.  
  563.     O   Controls OverThruster(TM) operation with the ro command (XMODEM,
  564.         XMODEM-1k, and YMODEM) downloads.  This parameter should be set as
  565.         follows:
  566.  
  567.         CompuServe XMODEM Negative numbers control the number of bytes added
  568.         to the window on XMODEM downloads from the CompuServe Information
  569.         Service.  Larger numbers increase throughput, but cause improperly
  570.         interfaced MNP modems on CIS nodes to drop characters under stress,
  571.         disrupting the file transfer.
  572.         EXAMPLE: dsz pO-512 ro file1.ext
  573.  
  574.         Other XMODEM Positive numbers up to a system dependent value less than
  575.         the protocol block size increase throughput.  Larger values induce
  576.         timeouts and/or retransmitted blocks.  The optimum value must be
  577.         determined by experiment.  60 usually give best results with MNP
  578.         modems at 2400 bps.  The optimum value varies depending on the remote
  579.         computer, modem(s), system traffic, and the network node.
  580.         EXAMPLE: dsz pO60 ro file1.ext
  581.  
  582.     S   Timeout in seconds (default 15) waiting for restraint release (XON
  583.         and/or handshake).
  584.  
  585.     W   Wait for Enter key before exiting after an error.  Effective on
  586.         registered copies.  Useful when calling dsz from DESQview, allows the
  587.  
  588.  
  589.  
  590.     Chapter 5              Rev 3-27-88  Typeset 3-29-88                      9
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.     Chapter 5                  DSZ Quick Reference                          10
  599.  
  600.  
  601.  
  602.         window to close unless there is an error message that should remain
  603.         visible.
  604.  
  605.     a   Calibrates certain protocol timeouts used with XMODEM and YMODEM
  606.         transfers (Cybernetic Data Recovery(TM)).  This parameter does not
  607.         affect ZMODEM transfers.
  608.  
  609.         The a numeric parameter is automatically set to 2000 for a 4.77 mHz PC
  610.         or XT, 4000 for a PS2/30, 6000 for an 8 mHz 1ws AT, and 12000 for a
  611.         PS2/80.  If your computer has a speedup card or otherwise runs
  612.         unusually fast (or slow!) for its type, you may set the a numeric
  613.         parameter to a value that reflects its speed.
  614.  
  615.         EXAMPLE: dsz port 2 pa4000 rb
  616.  
  617.  
  618.     d   A non zero value (the default) causes incoming files received with
  619.         ZMODEM and full YMODEM transfers to have their Date set to that sent
  620.         in the file header.  ZMODEM's file management features depend on the
  621.         transmission of each file's modification date.  Files will have the
  622.         same creation date, even if the two machines are in different time
  623.         zones.  When transferring files to/from a Unix system, creation dates
  624.         are interpreted according to GMT or Universal Coordinated Time.  File
  625.         dating may be disabled with a pd1 command.
  626.         NOTE: Backdating file creation times may confuse some backup programs.
  627.  
  628.     v   Verbose level (debugging output) Negative values inhibit some routine
  629.         messages.  Setting v to 1 or greater causes serialized copies to ring
  630.         the bell when a transfer is done.
  631.  
  632.     z   Timezone in minutes behind GMT, used for ZMODEM and True YMODEM file
  633.         transfers to coordinate the actual date of the file with computers in
  634.         other time zones.  Effective on registered copies.  PDT or MST
  635.         corresponds to 420.  This may be preset with the ZONE DOS environment
  636.         variable.
  637.  
  638.  
  639.     6.  ENVIRONMENT VARIABLES
  640.  
  641.     The following DOS environment variables may be set to modify dsz
  642.     operation.
  643.  
  644.     DIRRX (Registered copies only.) Specifies the directory to receive
  645.         (download) files.  If the sting in DIRRX ends with "/", directory
  646.         and/or disk designators in the incoming pathname are stripped, and
  647.         only the stem (name and extension) is used.  Otherwise, if an incoming
  648.         file has an absolute pathname, the incoming pathname is used.
  649.  
  650.         EXAMPLE: C>set DIRRX=C:/rxdirect/
  651.         C>dsz rz -r
  652.  
  653.  
  654.  
  655.  
  656.     Chapter 6              Rev 3-27-88  Typeset 3-29-88                     10
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.     Chapter 6                  DSZ Quick Reference                          11
  665.  
  666.  
  667.  
  668.     DSZFILES (Registered copies only.) May contain a list of pathnames to
  669.         transmit, with entries separated by spaces.  If present, DSZFILES is
  670.         used in place of a normal command line list of files to send with the
  671.         sb and szcommands.
  672.  
  673.         EXAMPLE: C>set DSZFILES=file1 file2 file3 *.c
  674.         C>dsz port 2 handshake on sz -r
  675.  
  676.         In practice, this string would be built up by a calling program and
  677.         passed to dsz with a "spawnvpe" or "execvpe" subroutine call.
  678.  
  679.     DSZLOG log file to receive entries for files sent and received.  (Default
  680.         null).  Sample entries:
  681.  
  682.     Z  46532 38400 bps 3324 cps   0 errors    66 1024 DSZ.COM 1177
  683.     Z 124087 19200 bps 1880 cps   0 errors     6 1024 MXY.TMP 1177
  684.  
  685.         Transfer times are based on the DOS time of day clock and have one
  686.         second jitter.  As with all protocol throughput reports generated by
  687.         Omen Technology programs (and contrary to the false claims of some
  688.         critics), dsz's throughput figures for ZMODEM, Kermit, and True
  689.         YMODEM(TM) transfers do not take "credit" for pathname and/or protocol
  690.         overhead characters.  Dsz's throughput reports do not include the time
  691.         required to send the pathname.  This understates the true time
  692.         required to transfer files, but the time required to send the pathname
  693.         often depends on the alacrity of the operator, and thus does not
  694.         always reflect the performance of the protocol itself.
  695.  
  696.         Transfers measuring less than one second are reported as having 9999
  697.         characters per second throughput.
  698.  
  699.         The unlabeled numeric field after the error (retry) count is the
  700.         number of flow control stoppages encountered sending the file.  This
  701.         number gives an indication of flow control restrictions (overloaded
  702.         networks, etc.) encountered during the transfer.
  703.  
  704.         The last numeric field before the file name is the block or subpacket
  705.         length used for the last block in the file.
  706.  
  707.         The last field is the serial number of the other program, or -1 if
  708.         this information is not available.
  709.  
  710.         The code letter indicates the type of transfer, Z (ZMODEM), S
  711.         (X/YMODEM), R (X/YMODEM), E (error), or L (transfer terminated by loss
  712.         of data carrier).
  713.  
  714.         EXAMPLE: C>set plog=C:/yam/plog
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.     Chapter 6              Rev 3-27-88  Typeset 3-29-88                     11
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.     Chapter 6                  DSZ Quick Reference                          12
  731.  
  732.  
  733.  
  734.     DSZOPT String containing default options for DSZ file transfers.
  735.         Effective on registered copies only.  Options are optional modifiers
  736.         to the dsz sz, rz, sx, rx, sb, rb commands.
  737.  
  738.         An 8n may be appended to the string to make BBS (ANSI) graphics the
  739.         default for dsz's t command.  The ability to preset these options is
  740.         especially helpful for controlling ZMODEM automatic downloads from
  741.         dsz's t command.
  742.  
  743.         EXAMPLE: C>set DSZOPT=r
  744.         Enables dsz's intelligent Crash Recovery as a default.
  745.  
  746.         Let's say you wish ZMODEM crash recovery, and BBS "graphics" for the
  747.         term function:
  748.         C>set DSZOPT=r8g
  749.  
  750.  
  751.         WARNING: Do NOT include "ena" or any other commands in the DSZOPT
  752.         string.  With the exception of the "8g" mode, only **options** may be
  753.         placed in the DSZOPT string!  (Options are the letters that modify the
  754.         sz, rz, sb, etc. commands.  In "rz -r", "r" is an option.)
  755.  
  756.     MAXBYTES Maximum number of bytes allowed for transfer.  If this number is
  757.         exceeded, dsz skips the offending files (ZMODEM) or aborts remaining
  758.         files in the batch (YMODEM).
  759.  
  760.     DSZPORT Default communications port override, default 1.
  761.         EXAMPLE:
  762.         C>set DSZPORT=2
  763.  
  764.     ZONE sets the z numeric parameter to the number of minutes the current
  765.         local time lags GMT time.  PDT or MST corresponds to 420.  (Registered
  766.         copies only)
  767.         EXAMPLE:
  768.         C>set ZONE=420
  769.  
  770.  
  771.     7.  BACKGROUND OPERATION
  772.  
  773.     Three DESQview description files are provided to demonstrate background
  774.     operation with modest (66 kb window) memory requirements.  Dsz uses tight
  775.     C/ASM code, table driven CRC generators, and buffered receive and transmit
  776.     for good performance in the background without hogging CPU cycles.  On a
  777.     QIC Labs PC-AT clone, dsz can download files in the background (3
  778.     background clock ticks, 9 foreground clock ticks) with a throughput better
  779.     than 9600 bps.
  780.  
  781.     2S   Prompts for file name(s) and sends them with ZMODEM protocol.  File:
  782.          2S-PIF.DVP
  783.  
  784.  
  785.  
  786.  
  787.  
  788.     Chapter 7              Rev 3-27-88  Typeset 3-29-88                     12
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.     Chapter 7                  DSZ Quick Reference                          13
  797.  
  798.  
  799.  
  800.     2T   Talks to the modem and allows manual YMODEM (F3) or automatic ZMODEM
  801.          downloads.  File: 2T-PIF.DVP
  802.  
  803.     2A   Like 2T, but using Quarterdeck's dvansi.com memory resident ANSI CRT
  804.          device driver to process ANSI screen codes.  File: 2A-PIF.DVP DS.BAT
  805.          is the batch file used by 2A.
  806.  
  807.     These files are written for a port 2 local connection and \TMP directory,
  808.     but may be modified to suit your requirements using the DESQview CP
  809.     command.  The W numeric allows DESQview to close the window after dsz
  810.     finishes, providing a pleasant user interface.
  811.  
  812.     Operation at high speed (above 9600 bps) requires the DESQview "Optimize
  813.     communications" performance Advanced Setup option.
  814.  
  815.            ***********************************************************
  816.                                      WARNING
  817.     When running dsz under a multi tasking system such as DESQview, do not
  818.     allow two programs to access the same comm port at the same time.  At
  819.     best, such actions will disrupt communications.  At worst, your computer
  820.     will attempt to open a subspace channel to V'ger.
  821.            ***********************************************************
  822.  
  823.  
  824.     8.  CALLING DSZ FROM COMM PROGRAMS
  825.  
  826.     8.1  GT POWER 13.00
  827.  
  828.     GT Power version 13.00 includes a YMRX.BAT (YMODEM-g receive) file with an
  829.     "rz" command.  You guessed it, "rz" is for ZMODEM protocol (the z means
  830.     ZMODEM!).  Please change the file to use the correct "rb -g" for YMODEM-g.
  831.     The files ZMTX.ARC and GT1300.NOT available on many bulletin boards
  832.     contain useful information for GT Power users.
  833.  
  834.     8.2  PROCOMM
  835.  
  836.     DSZ may not operate properly when called from Procomm if Procomm has files
  837.     open at the time.
  838.  
  839.     When running under ProComm's Host mode, failure to use the CON command may
  840.     cause Procomm to lock up the computer.
  841.  
  842.     The POE, PCALL, DSZ_ZAP, and PROZ programs have been popular in
  843.     interfacing DSZ to Procomm's editor gateway.
  844.  
  845.     Hint: the DOS PATH environment variable must include Procomm's directory
  846.     to allow POE to locate all the POE files,.  The POE files should be stored
  847.     in the Procomm directory.  Setting the "PROCOMM" environment variable is
  848.     insufficient.
  849.  
  850.  
  851.  
  852.  
  853.  
  854.     Chapter 8              Rev 3-27-88  Typeset 3-29-88                     13
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.     Chapter 8                  DSZ Quick Reference                          14
  863.  
  864.  
  865.  
  866.     8.3  PROCOMM PLUS
  867.  
  868.     DSZ may not operate properly when called from Procomm if Procomm has files
  869.     open at the time.
  870.  
  871.     Here are some handy settings for Procomm Plus.
  872.  
  873.     First, set the DOS environment as necessary before running Procomm:
  874.     SET DSZPORT=2                           (Only needed for COM2)
  875.     SET DSZLOG=DSZ.LOG            (If you wish a log file)
  876.  
  877.     Then set Procomm's external protocol strings:
  878.     A- External protocol 1 upload filename  ...ZMODEMU
  879.     B- External protocol 1 download filename ... ZMODEMD
  880.  
  881.     And then some short batch files:
  882.     ZMODEMU.BAT:                  DSZ sz %1 %2 %3 %4 %5 %6 %7 %8 %9
  883.     ZMODEMD.BAT:    DSZ rz
  884.  
  885.     All this and you still don't have Command Download and file AutoDownload,
  886.     but then "you pays your money and takes yer choice".
  887.  
  888.     8.4  BULLETIN BOARDS
  889.  
  890.     When installing dsz on a bulletin board or host system, be sure to check
  891.     for proper operation when the caller hangs up while a file is being sent
  892.     or recieved.
  893.  
  894.     Currently, Only the TurboC version supports file sharing (shared read
  895.     access on files sent by  dsz).
  896.  
  897.     Some bulletin board interface routines do not call dsz to send a file
  898.     until they have verified the file's existience by opening the file.  If
  899.     this checking is done in MS-DOS's default exclusive open mode, dsz's file
  900.     sharing will be defeated.
  901.  
  902.  
  903.     9.  FLOW CONTROL
  904.  
  905.     If you plan to send files, please refer to the Pro-YAM, PowerCom, or ZCOMM
  906.     manual FLOW CONTROL chapter for important information on flow control
  907.     considerations necessary for proper operation of ZMODEM and other
  908.     streaming protocols with buffered (error correcting) modems and/or
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.     Chapter 9              Rev 3-27-88  Typeset 3-29-88                     14
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.     Chapter 9                  DSZ Quick Reference                          15
  929.  
  930.  
  931.  
  932.     networks.
  933.  
  934.  
  935.     10.  ERROR MESSAGES
  936.  
  937.     Using COM{1|2} Carrier Detect {DISABLED|enabled}
  938.     Command line = (commands)
  939.     This is a normal message displayed to help resolve problems with incorrect
  940.     batch files.
  941.  
  942.     Unknown Machine Type XX, 'a' parameter preset to 6000 indicates a ROM BIOS
  943.     that does not follow the IBM specification for identifying the machine
  944.     type.  If your computer causes dsz to display this message, you may set
  945.     the a numeric parameter described elsewhere in this document.  This
  946.     message is generated before any commands are read, so do not be alarmed
  947.     when setting the a parameter doesn't make this message go away.  The a
  948.     parameter does not affect ZMODEM transfers.
  949.  
  950.     Need more memory to run DSZ or Abnormal program termination is printed by
  951.     the TurboC startup routine if dsz is run in too small a memory partition.
  952.     If you see this message, use a larger memory partition for dsz or remove
  953.     some memory resident programs.  This message may also appear if the
  954.     calling program fails to free memory before calling dsz.
  955.  
  956.     Carrier Lost is printed when dsz recognizes a loss or lack or carrier
  957.     detect signal from the modem.  This is caused by a line disconnect,
  958.     defective cable, or incorrect modem strapping.  It may be disabled with
  959.     the d command.
  960.  
  961.     Garbage Count Exceeded Indicates ZMODEM has not detected a valid start of
  962.     header in a reasonable number of characters.
  963.  
  964.     If dsz becomes "stuck" on emitting this messages, it is possible the
  965.     sending program may not be able to recognize and act upon transmission
  966.     requests (ZROPS headers).  The sending program should be corrected.  In
  967.     the meantime, setting a ZMODEM packet length with the "zmodem pl4000"
  968.     command forces the sender to wait for the receivers' progress reports.
  969.  
  970.     Permission denied comes from the Microsoft C Library.  This may be caused
  971.     by attempts to modify a read only file or directory, or create a file in a
  972.     nonexistient directory.
  973.  
  974.     A furtive flashing appearance of XOFF or FLOW during ZMODEM or YMODEM-g
  975.     file sending signifies dsz is responding to flow control restraint.  This
  976.     is normal operation when buffered modems or packet switched networks are
  977.     used.  ZMODEM's robustness and reliability allow creative users to
  978.     transfer files over unusual multiple computer lash-ups, causing modem data
  979.     lights and computer status displays to dance in unfamiliar rhythms.
  980.  
  981.     ZRPOS indicates the receiving program has detected a transmission error
  982.     and has requested a retransmission.  In other words, ZMODEM is doing its
  983.  
  984.  
  985.  
  986.     Chapter 10             Rev 3-27-88  Typeset 3-29-88                     15
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.     Chapter 10                 DSZ Quick Reference                          16
  995.  
  996.  
  997.  
  998.     job detecting and correcting garbled data.
  999.  
  1000.     Less commonly encountered dsz error messages are explained in the Pro-YAM
  1001.     manual.
  1002.  
  1003.  
  1004.     11.  IN CASE OF DIFFICULTY
  1005.  
  1006.     If you have difficulty getting dsz to work, start with the following
  1007.     command to dsz directly from the DOS prompt, without running any other
  1008.     COMM program:
  1009.                                   dsz port 1 speed 2400 d t
  1010.     (Change the port number and speed as necessary.) This connects you to the
  1011.     modem.  Dial a bulletin board by typing AT commands to the modem
  1012.     ("ATDP621-3746").  Log in, and request a ZMODEM download.  The file will
  1013.     transfer automatically.
  1014.  
  1015.     The "sb" and "sz" commands exploit DOS's tree structured file system.  An
  1016.     "sz" command with no file specified sends all the files in the current
  1017.     directory.  A directory or disk specifier expands to all files in that
  1018.     directory.
  1019.  
  1020.  
  1021.     11.1  COMMAND NOT FOUND
  1022.  
  1023.     If you see this message, make sure DSZ is in the DOS PATH.  Too many
  1024.     environment variable strings may also cause problems.
  1025.  
  1026.  
  1027.     11.2  DOS 3.x
  1028.  
  1029.     DOS 3.x systems may need to have a "STACKS = 8,256" line in CONFIG.SYS to
  1030.     prevent antisocial behavior. This is required on the NEC Multispeed, or if
  1031.     certain TSR's are used.
  1032.  
  1033.  
  1034.     11.3  Lockups
  1035.  
  1036.     DSZ is fastidious about which interrupt vectors it takes over.  Unlike
  1037.     some COMM programs, DSZ grabs only the correct interrupt vector for its
  1038.     interrupt service routine.  This allows multi line operation under
  1039.     DESQview and other multitasking systems.
  1040.  
  1041.     However, some incorrectly optioned serial ports will work with programs
  1042.     that pig out both IRQ3 and IRQ4, but they will lock up with DSZ.  If DSZ
  1043.     locks up the machine as soon as it tries to send or receive data, this is
  1044.     usually the fault.  Make sure the comm port is strapped correctly; COM1
  1045.     uses IRQ4, COM2 uses IRQ3.  DSZ will lock up if the comm port is not
  1046.     properly set up.
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.     Chapter 11             Rev 3-27-88  Typeset 3-29-88                     16
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.     Chapter 11                 DSZ Quick Reference                          17
  1061.  
  1062.  
  1063.  
  1064.     11.4  Brain Damaged UARTS
  1065.  
  1066.     Omen Technology has received reports of problems with defective 8250 typt
  1067.     UART integrated circuits in Leading Edge modem boards, serial port
  1068.     interfaces, and computers.  The defective chip logic affects high
  1069.     performance software.  Replacing the buggy chip with a newer chip (16450
  1070.     or 16550A) corrects the problem.
  1071.  
  1072.  
  1073.     11.5  Weird Iron
  1074.  
  1075.     A few machines, some with V20 CPUs, don't like DSZ.COM.  We have not been
  1076.     able to repeat this; TeleGodzilla (using a V20) runs DSZ.COM without a
  1077.     hitch.  Switching to DSZ.EXE has cleared up the problems on other
  1078.     machines.
  1079.  
  1080.  
  1081.     11.6  Will the real YMODEM please stand up?
  1082.  
  1083.     Some XMODEM programs claiming to support YMODEM do not send or accept the
  1084.     YMODEM pathname block.  1024 byte XMODEM is XMODEM-1k, not YMODEM as
  1085.     defined by Ward Christensen in 1985 when he coined the word.  1987
  1086.     versions of YMODEM.DOC remind the reader of the official YMODEM
  1087.     definition.
  1088.  
  1089.  
  1090.     11.7  PC-AT Extended Memory
  1091.  
  1092.     Virtual memory disk caches and ramdisks using 80286 extended memory
  1093.     require a hardware reset of the 80286 chip to return to the normal "real
  1094.     mode" after accessing extended memory.  This interference to the interrupt
  1095.     response time causes lost characters on comm ports, and may be minimized
  1096.     by specifying shorter memory transfers.
  1097.  
  1098.     Switching to National 16550A UART chips helps tremendously, allowing
  1099.     transfers at 115200 bps instead of 9600 bps with a standard 8250.
  1100.  
  1101.  
  1102.     12.  ASSOCIATED DOCUMENTS
  1103.  
  1104.     Consult the Professional-YAM, PowerCom, or ZCOMM manual chapter "OPTIONS
  1105.     FOR FILE TRANSFERS" for option meanings.  The "FILE TRANSFER BASICS"
  1106.     chapter explains the relative merits of XMODEM, YMODEM, ZMODEM, and other
  1107.     protocols and gives tips on their use.  The "MAIN COMMANDS" chapter
  1108.     describes the rb, rx, rc, rz, sb, and sz commands.  The "MODEM
  1109.     INTERFACING" and "FLOW CONTROL" chapters contain important information on
  1110.     the use of buffered modems with dsz.
  1111.  
  1112.     Information on the ZMODEM Inter Application File Transfer Protocol may be
  1113.     found in ZMODEM.DOC, part of YZMODEM.ZOO (yzmodem.arc).
  1114.  
  1115.  
  1116.  
  1117.  
  1118.     Chapter 12             Rev 3-27-88  Typeset 3-29-88                     17
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.     Chapter 12                 DSZ Quick Reference                          18
  1127.  
  1128.  
  1129.  
  1130.     C Source code for XMODEM, YMODEM, and ZMODEM transfers is included in
  1131.     RZSZ.ZOO.  This file includes a Pro-YAM/ZCOMM script to upload a bootstrap
  1132.     file to a Unix system, force its compilation, and (if the compilation is
  1133.     successful) upload the rz/sz source files.
  1134.  
  1135.  
  1136.     13.  FILES
  1137.  
  1138.     2S-PIF.DVP, 2A-PIF.DVP, DS.BAT, 2T-PIF.DVP DSZ.COM, and DSZ.DOC constitute
  1139.     Omen Technology's DSZ.ARC.
  1140.  
  1141.     2S-PIF.DVP, 2A-PIF.DVP, DS.BAT, and 2T-PIF.DVP are used with the DESQview
  1142.     multitasking for background operation.
  1143.  
  1144.     ZCOMMDOC.ARC (manual), ZCOMMEXE.ARC (programs), ZCOMMHLP.ARC (help
  1145.     processor and database), ZCOMM communications tools.
  1146.  
  1147.     YZMODEM.ARC contains XMODEM, YMODEM, and ZMODEM Protocol Descriptions.
  1148.  
  1149.     RZSZ.ARC contains XMODEM "C" source code.  (Unix/Xenix programs).
  1150.  
  1151.     DSZ.EXE compiled with the Xenix to DOS XC provides moderately higher
  1152.     maximum throughput (1700 vs 1300 cps downloading to a 4.77 mHz XT).  The
  1153.     speed difference is a function of the compiler, the source code is the
  1154.     same.  The Xenix XC version requires more memory, and does not support
  1155.     file sharing or a large I/O buffer.  This version is available in
  1156.     DSZEXE.ZOO.
  1157.  
  1158.     ZCOMM and Pro-YAM also run at a higher speed than DSZ.COM.
  1159.  
  1160.     Incompatible batch files may cause dsz to fail.
  1161.  
  1162.  
  1163.     14.  CHANGES
  1164.  
  1165.     Be sure to save the serial number/password card and putsnp program you
  1166.     received from Omen to use with future versions of DSZ you may download!
  1167.  
  1168.     3-29-88 There never was a 3-26-88 version, except for use by the
  1169.     Sandinista troops in Honduras.
  1170.  
  1171.     3-26-88 First general release compiled with TurboC version 1.5.
  1172.     Outstanding meganit: on certain networked systems, the reported number of
  1173.     files on batch send is ridiculous.
  1174.  
  1175.     This version no longer needs or accepts the "memory allocation patch".
  1176.  
  1177.     This version has a number of changes to ease interfacing and problem
  1178.     resolution.  The command line and acive com port are displayed to aid
  1179.     debugging of batch files that call DSZ.
  1180.  
  1181.  
  1182.  
  1183.  
  1184.     Chapter 14             Rev 3-27-88  Typeset 3-29-88                     18
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.     Chapter 14                 DSZ Quick Reference                          19
  1193.  
  1194.  
  1195.  
  1196.     The DIRRX environment variable may be used to specify sending and
  1197.     receiving files.  If the DIRRX environment variable ends with a slash, any
  1198.     drive designators and/or directory names in the incoming file are
  1199.     stripped.
  1200.  
  1201.     The DSZFILES environment variable may be used to specify an alternate list
  1202.     of pathnames to transmit whose length is not limited by the DOS command
  1203.     line.  It is typically used by calling programs using one of the C library
  1204.     "spawn" functions.
  1205.  
  1206.     Setting the v (verbose) parameter to 1 or greater causes serialized copies
  1207.     to ring the bell when a transfer is done.
  1208.  
  1209.     With the sz command, the k option forces a 1024 byte subpacket length and
  1210.     locks out adaptive subpacket size optimizations for the duration of the
  1211.     command.
  1212.  
  1213.     EXAMPLE: sz -k *.c *.h
  1214.  
  1215.  
  1216.     2-28-88 More changes in DSZ.DOC, no changes to the software.
  1217.  
  1218.     2-8-88 DSZ.DOC has been extensively rewritten and reorganized.  Dsz now
  1219.     supports the advanced buffering of the National 16550A and Intel 82510
  1220.     serial interface devices.  ZMODEM subpacket length adjustment has been
  1221.     improved to deal with Telenet congestion.
  1222.  
  1223.     Pirated/hacked versions of DSZ have cost users and dsz's developer
  1224.     thousands of dollars in lost time and other expenses, in addition to
  1225.     injuring the reputation of Omen Technology and its products.  Regrettably,
  1226.     Omen Technology cannot support prior versions of dsz because of this
  1227.     piracy.
  1228.  
  1229.     Name             Length                           Date        Time   CRC
  1230.     dsz.com          49896  Squeezed   10%     45116  29 Mar 88   2:35a  a674
  1231.     dsz.com          47986  Squeezed   10%     43529   8 Feb 88   8:44a  c57e
  1232.  
  1233.     Your copy of dsz show show this information as provided by
  1234.  
  1235.            arc v dsz.arc
  1236.     or
  1237.           pkxarc -v dsz.arc
  1238.  
  1239.     If your copy shows a different CRC or file length, insist on a legitimate
  1240.     copy and report the source of the pirated copy to Omen Technology Inc.
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.     Chapter 15             Rev 3-27-88  Typeset 3-29-88                     19
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.     Chapter 15                 DSZ Quick Reference                          20
  1259.  
  1260.  
  1261.  
  1262.     15.  ACKNOWLEDGEMENTS
  1263.  
  1264.     32 bit CRC code courtesy Gary S. Brown.
  1265.  
  1266.     Cybernetic Data Recovery(TM), Error Containment(TM), OverThruster(TM),
  1267.     Password Guardian(TM), CryptoScript(TM), and TurboDial(TM) are Omen
  1268.     Technology trademarks.
  1269.  
  1270.     PowerCom was trademarked in 1985 by POLYTRON Corporation, Hillsboro
  1271.     Oregon.
  1272.  
  1273.     Dsz and this documentation are Copyright 1988 by Omen Technology Inc, all
  1274.     rights reserved.  True YMODEM(TM) is an Omen Technology Trademark
  1275.     signifying YMODEM protocol support that meets the full YMODEM
  1276.     specification.
  1277.  
  1278.                            Omen Technology Incorporated
  1279.                           The High Reliability Software
  1280.  
  1281.                        17505-V Northwest Sauvie Island Road
  1282.                               Portland Oregon 97231
  1283.                   Modem: 503-621-3746 Speed 1200,2400,19200 PEP
  1284.                          Compuserve:70007,2304  GEnie:CAF
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.     Chapter 15             Rev 3-27-88  Typeset 3-29-88                     20
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.                                      CONTENTS
  1329.  
  1330.  
  1331.      1.  LICENSING INFORMATION............................................   2
  1332.          1.1   Sharing DSZ Files..........................................   2
  1333.          1.2   REGISTRATION...............................................   3
  1334.          1.3   Files on User Disk.........................................   4
  1335.          1.4   Bulletin Board Registration................................   4
  1336.  
  1337.      2.  DESCRIPTION......................................................   5
  1338.  
  1339.      3.  COMMANDS.........................................................   6
  1340.          3.1   Interrupt Keys.............................................   8
  1341.  
  1342.      4.  EXAMPLES.........................................................   8
  1343.  
  1344.      5.  NUMERIC PARAMETERS...............................................   9
  1345.  
  1346.      6.  ENVIRONMENT VARIABLES............................................  10
  1347.  
  1348.      7.  BACKGROUND OPERATION.............................................  12
  1349.  
  1350.      8.  CALLING DSZ FROM COMM PROGRAMS...................................  13
  1351.          8.1   GT POWER 13.00.............................................  13
  1352.          8.2   PROCOMM....................................................  13
  1353.          8.3   PROCOMM PLUS...............................................  14
  1354.          8.4   BULLETIN BOARDS............................................  14
  1355.  
  1356.      9.  FLOW CONTROL.....................................................  14
  1357.  
  1358.     10.  ERROR MESSAGES...................................................  15
  1359.  
  1360.     11.  IN CASE OF DIFFICULTY............................................  16
  1361.          11.1  COMMAND NOT FOUND..........................................  16
  1362.          11.2  DOS 3.x....................................................  16
  1363.          11.3  Lockups....................................................  16
  1364.          11.4  Brain Damaged UARTS........................................  17
  1365.          11.5  Weird Iron.................................................  17
  1366.          11.6  Will the real YMODEM please stand up?......................  17
  1367.          11.7  PC-AT Extended Memory......................................  17
  1368.  
  1369.     12.  ASSOCIATED DOCUMENTS.............................................  17
  1370.  
  1371.     13.  FILES............................................................  18
  1372.  
  1373.     14.  CHANGES..........................................................  18
  1374.  
  1375.     15.  ACKNOWLEDGEMENTS.................................................  20
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.                                       - i -
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.           DSZ - a ZMODEM, True YMODEM(TM), XMODEM File Transfer Program
  1393.  
  1394.  
  1395.                                   Chuck Forsberg
  1396.  
  1397.                                Omen Technology Inc
  1398.  
  1399.  
  1400.                                      ABSTRACT
  1401.  
  1402.  
  1403.  
  1404.                       ZMODEM - Not just another XMODEM hack
  1405.  
  1406.     The ZMODEM file transfer protocol provides reliable file and command
  1407.     transfers with complete END-TO-END data integrity between application
  1408.     programs.  ZMODEM's 32 bit CRC protects against errors that continue to
  1409.     sneak into even the most advanced networks.
  1410.  
  1411.     Unlike traditional and many recently introduced protocols, ZMODEM
  1412.     safeguards all data and supervisory information with effective error
  1413.     detection.
  1414.  
  1415.     ZMODEM rapidly transfers files, particularly with buffered (error
  1416.     correcting) modems, timesharing systems, satellite relays, and wide area
  1417.     packet switched networks.
  1418.  
  1419.     User Friendliness is an important ZMODEM feature.  ZMODEM AutoDownload
  1420.     (Automatic file Download initiated without user intervention) greatly
  1421.     simplifies file transfers compared to the traditional protocols.
  1422.  
  1423.     ZMODEM provides advanced file management features including Crash
  1424.     Recovery, flexible control of selective file transfers, and security
  1425.     verified command downloading.
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.